Keyboard
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Die Keyboard
-Schnittstelle der Keyboard API bietet Funktionen, die Tastaturlayout-Karten abrufen und das Erfassen von Tastendrücken von der physischen Tastatur umschalten.
Eine Liste gültiger Code-Werte finden Sie in der Spezifikation UI Events KeyboardEvent code Values.
Instanz-Eigenschaften
Erbt auch Eigenschaften von ihrer Elternschnittstelle, EventTarget
.
Instanz-Methoden
Erbt auch Methoden von ihrer Elternschnittstelle, EventTarget
.
Keyboard.getLayoutMap()
Experimentell-
Gibt ein
Promise
zurück, das mit einer Instanz vonKeyboardLayoutMap
aufgelöst wird, die ein Map-ähnliches Objekt mit Funktionen zum Abrufen der Strings ist, die mit bestimmten physischen Tasten verbunden sind. Keyboard.lock()
Experimentell-
Gibt ein
Promise
zurück, das sich auflöst, nachdem das Erfassen von Tastendrücken für eine oder alle Tasten auf der physischen Tastatur aktiviert wurde. Keyboard.unlock()
Experimentell-
Entsperrt alle Tasten, die durch die Methode
lock()
erfasst wurden, und gibt synchron zurück.
Beispiel
Tastaturzuordnung
Das folgende Beispiel zeigt, wie man den orts- oder layoutspezifischen String erhält, der der Taste entspricht, die der 'W'-Taste auf einer englischen QWERTY-Tastatur entspricht.
if (navigator.keyboard) {
const keyboard = navigator.keyboard;
keyboard.getLayoutMap().then((keyboardLayoutMap) => {
const upKey = keyboardLayoutMap.get("KeyW");
window.alert(`Press ${upKey} to move up.`);
});
} else {
// Do something else.
}
Tastatursperre
Das folgende Beispiel erfasst die Tasten W, A, S und D>, indem
lock()` mit einer Liste aufgerufen wird, die den Schlüsselattributwert für jede dieser Tasten enthält:
navigator.keyboard.lock(["KeyW", "KeyA", "KeyS", "KeyD"]);
Dies erfasst diese Tasten unabhängig davon, welche Modifikatoren mit dem Tastendruck verwendet werden. Angenommen, ein Standard-QWERTY-Layout der Vereinigten Staaten ist in Verwendung, stellt die Registrierung KeyW
sicher, dass W, Shift+W, Control+W, Control+Shift+W, und alle anderen Tastenmodifikator-Kombinationen mit W an die App gesendet werden. Das Gleiche gilt für KeyA
, KeyS
und KeyD
.
Spezifikationen
Specification |
---|
Keyboard Map # keyboard-interface |
Keyboard Lock # keyboard-interface |